MV_CC_OpenDevice

MV_CC_OpenDevice

Open the device (connect the device).

API Definition

int MV_CC_OpenDevice(
  void              *handle,
  unsigned int      nAccessMode = MV_ACCESS_Exclusive,
  unsigned short    nSwitchoverKey = 0
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

nAccessMode

[IN] Device access mode, it is exclusive mode by default, see the table below for details.

Macro Definition

Value

Description

MV_ACCESS_Exclusive

1

Exclusive permission, for other apps, the CCP register is only allowed to be read

MV_ACCESS_ExclusiveWithSwitch

2

Preempt permission in mode 5, and then open with exclusive permission

MV_ACCESS_Control

3

Control permission, for other apps, all registers are allowed to be read

MV_ACCESS_ControlWithSwitch

4

Preempt permission in mode 5, and then open with control permission

MV_ACCESS_ControlSwitchEnable

5

Open with control permission that can be preempted

MV_ACCESS_ControlSwitchEnableWithKey

6

Preempt permission in mode 5, and then open with control permission that can be preempted

MV_ACCESS_Monitor

7

Open device with reading mode, suitable under control permission

nSwitchoverKey

[IN] Key for switching permissions, it is null by default, and it is valid when access mode supports permission switching (2/4/6 mode).

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

  • You can find the specific device and connect according to inputted device parameters.

  • When calling this API, the parameters nAccessMode and nSwitchoverKey are optional, and the device access mode is exclusive by default. Currently the device does not support the following preemption modes: MV_ACCESS_ExclusiveWithSwitch, MV_ACCESS_ControlWithSwitch, and MV_ACCESS_ControlSwitchEnableWithKey.

  • For USB3Vision device, the parameters nAccessMode and nSwitchoverKey are invalid.

The following sample code is for reference only.

#include "MvCameraControl.h"

void main()
{
    int nRet = -1;
    void* m_handle = NULL;

    //Enumerate all devices corresponding to specified transport protocol within subnet
    unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
    MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
    int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
    if (MV_OK != nRet)
    {
        printf("error: EnumDevices fail [%x]\n", nRet);
        return;
    }

    int i = 0;
    if (m_stDevList.nDeviceNum == 0)
    {
        printf("no camera found!\n");
        return;
    }

    //Select the first found online device and create device handle
    int nDeviceIndex = 0;

    MV_CC_DEVICE_INFO m_stDevInfo = {0};
    memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));

    nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);

    if (MV_OK != nRet)
    {
        printf("error: CreateHandle fail [%x]\n", nRet);
        return;
    }

    unsigned int nAccessMode = MV_ACCESS_Exclusive;
    unsigned short nSwitchoverKey = 0;

    //Connect device
    nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
    if (MV_OK != nRet)
    {
        printf("error: OpenDevice fail [%x]\n", nRet);
        return;
    }  

    //...other processing

    //Shut device and release resource
    nRet = MV_CC_CloseDevice(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: CloseDevice fail [%x]\n", nRet);
        return;
    }

    //Destroy handle and release resource
    nRet = MV_CC_DestroyHandle(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: DestroyHandle fail [%x]\n", nRet);
        return;
    }
}

MV_CC_OpenDevice

Open the device (connect the device).

API Definition

int MV_CC_OpenDevice(
  void              *handle,
  unsigned int      nAccessMode = MV_ACCESS_Exclusive,
  unsigned short    nSwitchoverKey = 0
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

nAccessMode

[IN] Device access mode, it is exclusive mode by default, see the table below for details.

Macro Definition

Value

Description

MV_ACCESS_Exclusive

1

Exclusive permission, for other apps, the CCP register is only allowed to be read

MV_ACCESS_ExclusiveWithSwitch

2

Preempt permission in mode 5, and then open with exclusive permission

MV_ACCESS_Control

3

Control permission, for other apps, all registers are allowed to be read

MV_ACCESS_ControlWithSwitch

4

Preempt permission in mode 5, and then open with control permission

MV_ACCESS_ControlSwitchEnable

5

Open with control permission that can be preempted

MV_ACCESS_ControlSwitchEnableWithKey

6

Preempt permission in mode 5, and then open with control permission that can be preempted

MV_ACCESS_Monitor

7

Open device with reading mode, suitable under control permission

nSwitchoverKey

[IN] Key for switching permissions, it is null by default, and it is valid when access mode supports permission switching (2/4/6 mode).

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

  • You can find the specific device and connect according to inputted device parameters.

  • When calling this API, the parameters nAccessMode and nSwitchoverKey are optional, and the device access mode is exclusive by default. Currently the device does not support the following preemption modes: MV_ACCESS_ExclusiveWithSwitch, MV_ACCESS_ControlWithSwitch, and MV_ACCESS_ControlSwitchEnableWithKey.

  • For USB3Vision device, the parameters nAccessMode and nSwitchoverKey are invalid.

The following sample code is for reference only.

#include "MvCameraControl.h"

void main()
{
    int nRet = -1;
    void* m_handle = NULL;

    //Enumerate all devices corresponding to specified transport protocol within subnet
    unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
    MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
    int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
    if (MV_OK != nRet)
    {
        printf("error: EnumDevices fail [%x]\n", nRet);
        return;
    }

    int i = 0;
    if (m_stDevList.nDeviceNum == 0)
    {
        printf("no camera found!\n");
        return;
    }

    //Select the first found online device and create device handle
    int nDeviceIndex = 0;

    MV_CC_DEVICE_INFO m_stDevInfo = {0};
    memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));

    nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);

    if (MV_OK != nRet)
    {
        printf("error: CreateHandle fail [%x]\n", nRet);
        return;
    }

    unsigned int nAccessMode = MV_ACCESS_Exclusive;
    unsigned short nSwitchoverKey = 0;

    //Connect device
    nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
    if (MV_OK != nRet)
    {
        printf("error: OpenDevice fail [%x]\n", nRet);
        return;
    }  

    //...other processing

    //Shut device and release resource
    nRet = MV_CC_CloseDevice(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: CloseDevice fail [%x]\n", nRet);
        return;
    }

    //Destroy handle and release resource
    nRet = MV_CC_DestroyHandle(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: DestroyHandle fail [%x]\n", nRet);
        return;
    }
}